{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# 17 - Predictive Models 101\n",
    "\n",
    "We are leaving Part I of this book. That part covered the core about causal inference. Techniques over there are very well known and established. They have survived the test of time. Part I builds the solid foundation we can rely upon. In more technical terms, Part I focuses on defining what is causal inference, what are the biases that prevents correlation from being causation, multiple ways to adjust for those biases (regression, matching and propensity score) and canonical identification strategies (instrumental variables, diff-in-diff and RDD). In summary, Part I focuses on the standard techniques we use to identify the average treatment effect $E[Y_1 - Y_0]$. \n",
    " \n",
    "As we move to Part II, things will get a bit shaky. We will cover recent developments in the causal inference literature, its relationship with Machine Learning and applications in the industry. In that sense, we trade-off academic rigour for applicability and empiricism. Some methods presented in Part II don't have a solid theory about why they work. Still, when we try them, they seem to work nevertheless. In that sense, Part II might be more useful for industry practitioners that want to use causal inference in their day to day work, rather than scientists who want to research a fundamental causal relationship in the world. \n",
    " \n",
    "The first few chapters of part two will focus on estimating heterogeneous treatment effects. We will move from a world where all we cared about was the average treatment effect, $E[Y_1 - Y_0]$, to one where we want to know how different units respond differently to the treatment $E[Y_1 - Y_0 | X]$. This is the world where personalisation is paramount. We want to prioritise treating those whose treatment effect will be the most impactful and we don't want to treat those to whom the treatment will be harmful. In a sense, we are also moving from a positive question about what is the average treatment effect to a normative question: who should we treat? \n",
    " \n",
    "This is the question most businesses ask themselves, albeit in slightly different terms: who should I give discounts to? What interest rate should I charge on a loan? What item should I recommend to this user? What page layout should I show to each customer? Those are all treatment effect heterogeneity questions that we can answer with the tools presented in Part II. But before we do that, it's only fair that I present what Machine Learning means to the industry, as this will become a fundamental tool we will later use for causal inference. \n",
    "\n",
    "\n",
    "## Machine Learning in the Industry\n",
    " \n",
    "The focus of this chapter is to talk about how we normally use **machine learning** in the industry. If you are not familiar with machine learning, you can see this chapter as a machine learning crash course. And if you've never worked with ML before, I strongly recommend you learn at least the basics to get the most out of what's to come. But this doesn't mean you should skip this chapter if you are already versed in ML. I still think you will benefit from reading it through. Differently from other machine learning material, this one will **not** discuss the ins and outs of algorithms like decision trees or neural networks. Instead, it will be laser focused on **how machine learning is applied in the real world**.\n",
    " \n",
    "![img](./data/img/industry-ml/ml-meme.png)\n",
    " \n",
    "The first thing I want to adress is why are we talking about machine learning in a causal inference book? The short answer is because I think one of the best ways to understand causality is to put it in contrast with the predictive models approach brought by machine learning. The long answer is twofold. First, if you've got to this point in this book, there is a high chance you are already familiar with machine learning. Second, even if you aren't, given the current popularity of these topics, you probably already have some idea on what they are. The only problem is that, with all the hype around machine learning, I might have to bring you back to earth and explain what it really does in very practical terms. Finally, more recent developments in causal inference make heavy use of machine learning algorithms, so there is that too. \n",
    " \n",
    "Being very direct, **machine learning is a way to make fast, automatic and good predictions**. That's not the entire picture, but it covers 90% of it. It's in the field of supervised machine learning where most of the cool advancements, like computer vision, self-driving cars, language translation and diagnostics, have been made. Notice how, at first, these might not seem like prediction tasks. How is language translation a prediction? And that's the beauty of machine learning. We can solve more problems with prediction than what is initially apparent. In the case of language translation, you can frame it as a prediction problem where you present a machine with one sentence and it has to predict the same sentence in another language. Notice that I'm **not** using the word prediction in a forecasting or anticipating the future sense. Prediction is simply mapping from one defined input to an initially unknown but equally well defined and observable output. \n",
    " \n",
    "![img](./data/img/industry-ml/translation.png)\n",
    " \n",
    "What machine learning really does is it learns this mapping function, even if it is a very complicated mapping function. The bottom line is that if you can frame a problem as this mapping from an input to an output, then machine learning might be a good candidate to solve it. As for self-driving cars, you can think of it as not one, but multiple complex prediction problems: predicting the correct angle of the wheel from sensors in the front of the car, predicting the pressure in the brakes from cameras around the car, predicting the pressure in the accelerator from gps data. Solving those (and a tone more) of prediction problems is what makes a self driving car.\n",
    "\n",
    "A more technical way of thinking about ML is in term of estimating (possibly very complex) expectation functions: \n",
    " \n",
    "$\n",
    "E[Y|X]\n",
    "$\n",
    " \n",
    "Where $Y$ is what you want to know (translated sentence, diagnostica) and $X$ is what you already know (input sentence, x-ray image). Machine learning is simply a way of estimating that conditional expectation function. \n",
    "\n",
    "\n",
    "OK… You now understand how prediction can be more powerful than we first thought. Self-driving cars and language translation are cool and all, but they are quite distant, unless you work at a major tech company like Google or Uber. So, to make things more relatable, let's talk in terms of problems almost every company has: customer acquisition (that is getting new customers). \n",
    " \n",
    "From the customer acquisition perspective, what you often have to do is figure out who the profitable customers are. In this problem, each customer has a cost of acquisition (maybe marketing costs, onboarding costs, shipping costs...) and will hopefully generate a positive cashflow for the company. For example, let's say you are an internet provider or a gas company. Your typical customer might have a cash flow that looks something like this.\n",
    " \n",
    "![img](./data/img/industry-ml/cashflow-1.png)\n",
    " \n",
    "Each bar represents a monetary event in the life of your relationship with the customer. For example, to get a customer, right off the bat, you need to invest in marketing. Then, after someone decides to do business with you, you might incur some sort of onboarding cost (where you have to explain to your customer how to use your product) or installation costs. Only then, the customer starts to generate monthly revenues. At some point, the customer might need some assistance and you will have maintenance costs. Finally, if the customer decides to end the contract, you might have some final costs for that too. \n",
    " \n",
    "To see if this is a profitable customer, we can rearrange the bar in what is called a cascade plot. Hopefully, the sum of the cash events end up way above the zero line.\n",
    " \n",
    "![img](./data/img/industry-ml/cascade-1.png)\n",
    " \n",
    "In contrast, it could very well be that the customer will generate much more costs than revenues. If he or she uses very little of your product and has high maintenance demands, when we pile up the cash events, they could end up below the zero line.\n",
    " \n",
    "![img](./data/img/industry-ml/cascade-2.png)\n",
    " \n",
    "Of course, this cash flow could be simpler or much more complicated, depending on the type of business. You can do stuff like time discounts with an interest rate and get all crazy about it, but I think the point here is made.\n",
    " \n",
    "But what can you do about this? Well, if you have many examples of profitable and non profitable customers, you can train a machine learning model to identify them. That way, you can focus your marketing strategies that engage only on the profitable customers. Or, if your contract permits, you can end relations with a customer before he or she generates more costs. Essentially, what you are doing here is **framing the business problem as a prediction problem so that you can solve it with machine learning**: you want to predict or identify profitable and unprofitable customers so that you only engage with the profitable ones."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "from sklearn import ensemble\n",
    "from sklearn.model_selection import train_test_split\n",
    "from sklearn.pipeline import Pipeline\n",
    "from sklearn.metrics import r2_score\n",
    "import seaborn as sns\n",
    "from matplotlib import pyplot as plt\n",
    "from matplotlib import style\n",
    "style.use(\"ggplot\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For instance, suppose you have 30 days of transactional data on 10000 customers. You also have the cost of acquisition `cacq`. This could be the bid you place for them if you are doing online marketing, it could be the cost of shipping or any training you have to do with your customer so they can use your product. Also, for the sake of simplicity (this is a crash course, not a semester on customer valuation), let's pretend you have total control of the customer that you do business with. In other words, you have the power to deny a customer even if he or she wants to do business with you. If that's the case, your task now becomes identifying who will be profitable beforehand, so you can choose to engage only with them."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(10000, 32)\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>customer_id</th>\n",
       "      <th>cacq</th>\n",
       "      <th>day_0</th>\n",
       "      <th>day_1</th>\n",
       "      <th>day_2</th>\n",
       "      <th>day_3</th>\n",
       "      <th>day_4</th>\n",
       "      <th>day_5</th>\n",
       "      <th>day_6</th>\n",
       "      <th>day_7</th>\n",
       "      <th>...</th>\n",
       "      <th>day_20</th>\n",
       "      <th>day_21</th>\n",
       "      <th>day_22</th>\n",
       "      <th>day_23</th>\n",
       "      <th>day_24</th>\n",
       "      <th>day_25</th>\n",
       "      <th>day_26</th>\n",
       "      <th>day_27</th>\n",
       "      <th>day_28</th>\n",
       "      <th>day_29</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>0</td>\n",
       "      <td>-110</td>\n",
       "      <td>6</td>\n",
       "      <td>0</td>\n",
       "      <td>73</td>\n",
       "      <td>10</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>21</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>1</td>\n",
       "      <td>-58</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>15</td>\n",
       "      <td>0</td>\n",
       "      <td>3</td>\n",
       "      <td>2</td>\n",
       "      <td>0</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2</td>\n",
       "      <td>-7</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>3</td>\n",
       "      <td>-30</td>\n",
       "      <td>0</td>\n",
       "      <td>3</td>\n",
       "      <td>2</td>\n",
       "      <td>0</td>\n",
       "      <td>9</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>40</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>4</td>\n",
       "      <td>-42</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>5 rows × 32 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "   customer_id  cacq  day_0  day_1  day_2  day_3  day_4  day_5  day_6  day_7  \\\n",
       "0            0  -110      6      0     73     10      0      0      0     21   \n",
       "1            1   -58      0      0      0     15      0      3      2      0   \n",
       "2            2    -7      0      0      0      0      0      0      0      1   \n",
       "3            3   -30      0      3      2      0      9      0      0      0   \n",
       "4            4   -42      0      0      0      0      0      0      0      0   \n",
       "\n",
       "   ...  day_20  day_21  day_22  day_23  day_24  day_25  day_26  day_27  \\\n",
       "0  ...       0       0       0       0       0       0       0       0   \n",
       "1  ...       0       0       0       0       0       0       0       0   \n",
       "2  ...       0       0       0       0       0       0       0       0   \n",
       "3  ...       0       0      40       0       0       0       0       0   \n",
       "4  ...       0       0       0       0       0       0       0       0   \n",
       "\n",
       "   day_28  day_29  \n",
       "0       0       0  \n",
       "1       0       0  \n",
       "2       0       0  \n",
       "3       0       0  \n",
       "4       0       0  \n",
       "\n",
       "[5 rows x 32 columns]"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "transactions = pd.read_csv(\"data/customer_transactions.csv\")\n",
    "print(transactions.shape)\n",
    "transactions.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "What we need to do now is distinguish the good from the bad customers according to this transactional data. For the sake of simplicity, I'll just sum up all transactions and the CACQ. Keep in mind that this throws under the rug a lot of nuances, like distinguishing customers that are churned from those that are in a break between one purchase and the next.\n",
    " \n",
    "I'll then join this sum, which I call `net_value`, with customer specific features. Since my goals is to figure out which customer will be profitable **before** deciding to engage with them, you can only use data prior to the acquisition period. In our case, these features are age, region and income, which are all available at another `csv` file."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>customer_id</th>\n",
       "      <th>region</th>\n",
       "      <th>income</th>\n",
       "      <th>age</th>\n",
       "      <th>net_value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>0</td>\n",
       "      <td>30</td>\n",
       "      <td>1025</td>\n",
       "      <td>24</td>\n",
       "      <td>130</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>1</td>\n",
       "      <td>41</td>\n",
       "      <td>1649</td>\n",
       "      <td>26</td>\n",
       "      <td>10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2</td>\n",
       "      <td>18</td>\n",
       "      <td>2034</td>\n",
       "      <td>33</td>\n",
       "      <td>-6</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>3</td>\n",
       "      <td>20</td>\n",
       "      <td>1859</td>\n",
       "      <td>35</td>\n",
       "      <td>136</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>4</td>\n",
       "      <td>1</td>\n",
       "      <td>1243</td>\n",
       "      <td>26</td>\n",
       "      <td>-8</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   customer_id  region  income  age  net_value\n",
       "0            0      30    1025   24        130\n",
       "1            1      41    1649   26         10\n",
       "2            2      18    2034   33         -6\n",
       "3            3      20    1859   35        136\n",
       "4            4       1    1243   26         -8"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "profitable = (transactions[[\"customer_id\"]]\n",
    "              .assign(net_value = transactions\n",
    "                      .drop(columns=\"customer_id\")\n",
    "                      .sum(axis=1)))\n",
    "\n",
    "customer_features = (pd.read_csv(\"data/customer_features.csv\")\n",
    "                     .merge(profitable, on=\"customer_id\"))\n",
    "\n",
    "customer_features.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Good! Our task is becoming less abstract. We wish to identify the profitable customers (`net_value > 0`) from the non profitable ones. Let's try different things and see which one works better. But before that, we need to take a quick look into Machine Learning (feel free skip if you know how ML works) \n",
    " \n",
    "## Machine Learning Crash Course\n",
    " \n",
    "For our intent and purpose, we can think of ML as an overpowered way of making predictions. For it to work, you need some data with labels or the ground truth of what you are predicting. Then, you can train a ML model on that data and use it to make predictions where the ground truth is not yet known. The image below exemplifies the typical machine learning flow.\n",
    " \n",
    "![img](./data/img/industry-ml/ml-flow.png)\n",
    " \n",
    "First, you need data where the ground truth, `net_value` here, is known. Then, you train a ML model that will use features - region, income and age in our case - to predict `net_value`. This training or estimating step will produce a machine learning model that can be used to make predictions about `net_value` when you don't yet have the true `net_value`. This is shown in the left part of the image. You have some new data where you have the features (region, income and age) but you don't know the `net_value` yet. So you pass this data through your model and it provides you with `net_value` predictions. \n",
    " \n",
    "If you are more into technical notation, another way of understanding machine learning is in term of estimating a conditional expectation $E[Y|X]$, where $Y$ is called the target variable or outcome and $X$ is called the feature variables. ML is just a powerful way of obtaining $\\hat{E}[Y|X]$, usually by optimizing some error or loss function.\n",
    " \n",
    "One tricky thing with ML models is that they can approximate almost any function. Another way of saying this is that they can be made so powerful as to perfectly fit the data in the training set. Machine learning models often have what we call complexity hyperparameters. These things adjust how powerful or complex the model can be. In the image below, you can see examples of a simple model (left), an intermediate model (middle) and a complex and powerful model (right). Notice how the complex model has a perfect fit of the training data.\n",
    " \n",
    "![img](./data/img/industry-ml/model-fit.png)\n",
    " \n",
    "This raises some problems. Namely, how can we know if our model is any good before using it to make predictions in the real world? One way we have is to compare the predictions with the actual values on the dataset where we have the ground truth. These are so-called goodness of fit metrics, like $R^2$. But remember that the model can be made so powerful as to perfectly fit the data. If this happens, the predictions will perfectly match the ground truth. This is problematic, because it means this validation is misleading, since we can nail it just by making my model more powerful and complex. \n",
    " \n",
    "Besides, it is generally **not** a good thing to have a very complex model. And you already have some intuition into why that is the case. In the image above, for instance, which model do you prefer? The more complex one that gets all the predictions right? Probably not. You probably prefer the middle one. It's smoother, simpler and yet, it still makes some good predictions, even if it doesn't perfectly fit the data.\n",
    " \n",
    "![img](./data/img/industry-ml/overfitting.jpg)\n",
    " \n",
    "Your intuition is in the right place. What happens if you give too much power to your model, is that it will not only learn the patterns in your data, but it also learns the random noise. Since the noise will be different when you use the model to make predictions in the real world (it's random after all), your \"perfect\" model will make mistakes. In ML terms, we say that models that are too complex are overfitting and don't generalize well. So, what can we do?\n",
    " \n",
    "We are going to pretend  we don't have access to parts of the data. The idea is to split the dataset for which we have the ground truth into two. Then, we can give one part for the model to train on and the other part we can use to validate the model predictions. This is called cross validation.\n",
    " \n",
    "![img](./data/img/industry-ml/test.png)\n",
    " \n",
    "In the dataset above, which the model didn't see during training, the complex model doesn't do a very good job. The model in the middle, on the other hand, seems to perform better. To choose the right model complexity, we can train different models, each one with a different complexity, and see how they perform on some data that we have the ground truth, but that was not used for training the model. Cross validation is so important we should probably spend more time on it."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Cross Validation\n",
    " \n",
    "Cross validation is essential for selecting the model complexity but it's useful beyond that. We can use it whenever we want to try many different things and estimate how they would play out in the real world. The idea being cross validation is to mimic the real world, where we estimate a model on the data that we have, but we make predictions on new, unseen data. The holdout data that we pretend not to have serves as a proxy to what we will encounter in the wild. \n",
    " \n",
    "Let's see how we can apply cross validation to the whole problem of figuring out which customers are profitable or not. Here is an outline of what we should do:\n",
    " \n",
    "1. We have data on existing customers. In this data, we know which ones are profitable and which ones are not (we know the ground truth). Let's call our internal data the training set.\n",
    "2. We will use the internal data to *learn* a rule that tells us which customer is profitable (hence training).\n",
    "3. We will apply the rule to the holdout data that was **not** used for learning the rule. This should simulate the process of learning a rule in one dataset and applying it to another, a process that will be inevitable when we go to production and score truly unseen data.\n",
    " \n",
    "Here is a picture of what cross validation looks like. There is the truly unseen data at the rightmost part of the image and then there is data that we only pretend not to have at learning time. \n",
    " \n",
    "![img](./data/img/industry-ml/cross-validation.png)\n",
    " \n",
    "To summarize, we will partition our internal data into a training and a test set. We can use the training set to come up with models or rules that predict if a customer is profitable or not, but we will validate those rules in another partition of the dataset: the test set. This test set will be hidden from our learning procedure. \n",
    " \n",
    "Just as a side note here, there are tons of ways to make cross validation better other than this simple train test split (k-fold cross-validation or temporal cross validation, for instance), but for the sake of what we will do here, this is enough. Remember that the spirit of cross validation is to simulate what would happen once we go to a production environment. By doing that we hope to get more realistic estimates.\n",
    " \n",
    "For our case, I won't do anything fancy. I'll just divide the dataset into two. 70% will be used to build a method that allows us to identify profitable customers and 30% will be used to evaluate how good that method is."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "((7000, 5), (3000, 5))"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train, test = train_test_split(customer_features, test_size=0.3, random_state=13)\n",
    "train.shape, test.shape"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Predictions and Policies\n",
    " \n",
    "![img](./data/img/industry-ml/profit.png)\n",
    " \n",
    "We've been talking about methods and approaches to identify profitable customers but it is time we get more precise with our concepts. Let's introduce two new ones. A **prediction** is a number that estimates or predicts something. It's the estimation of $\\hat{E}[y_i|X_i]$. For example, we can try to predict the profitability of a customer and the prediction would be something like 16 BRL, meaning that we predict this customer will generate 16 BRL in revenue. The point here is that prediction is a simple number. \n",
    " \n",
    "The second concept is that of a **policy**. A policy is an automatic decision rule. While a prediction is a number, a policy is a decision. For example, we can have a policy that engages with customers with income greater than 1000 and doesn't engage otherwise. We usually build policies on top of predictions: engage with all customers that have profitability predictions above 10 and don't engage otherwise, $\\hat{E}[y_i|X_i] > 10$. Machine learning will usually take care of the first concept, that is, of prediction. But notice that predictions alone are useless. We need to attach some decision, or policy to it.\n",
    " \n",
    "We can do very simple policies and models or very complicated ones. For both policies and predictions, we need to use cross validation, that is, estimate the policy or prediction in one partition of the data and validate its usefulness in another. Since we've already partitioned our data into two, we are good to go.\n",
    " \n",
    "## One Feature Policies\n",
    " \n",
    "Before we go machine learning crazy on this profitability problem, let's try the simple stuff first. The 80% gain with 20% effort stuff. This often work wonders and, surprisingly, most data scientists forget about it. So, what is the simplest thing we can do? Naturally, **just engage with all the customers!** Instead of figuring out which ones are profitable, let's just do business with everyone and hope the profitable customers more than compensate for the non profitable ones. \n",
    " \n",
    "To check if this is a good idea, we can see the average net value of the customers. If that turns out to be positive, it means that, on average, we will make money on our customers. Sure, there will be profitable and non profitable ones but, on average, if we have enough customers, we will make money. On the other hand, if this value is negative, it means that we will lose money if we engage with all the customers."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "-29.169428571428572"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "train[\"net_value\"].mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "That's a bummer... If we engage with everyone, we would lose about 30 reais for customers we do business with. Our first, very simple thing didn't work and we better find something more promising if we don't want to go out of business. Just a quick side note here, keep in mind that this is a pedagogical example. Although the very simple, \"treat everyone the same\" kind of policy didn't work here, they often do in real life. It is usually the case that sending a marketing email to everyone is better than not sending it, or giving discounts coupons to everyone is often better than not giving them. \n",
    " \n",
    "Moving forward, what is the next simplest thing we can think of? One idea is taking our features and seeing if they alone distinguish the good from the bad customers. Take `income`, for instance. It's intuitive that richer customers should be more profitable, right? What if we do business only with the top richest customers? Would that be a good idea?\n",
    " \n",
    "To figure this out we can partition our data into income quantiles (a quantile has the propriety of dividing the data into partitions of equal size, that's why I like them). Then, for each income quantile, let's compute the average net value. The hope here is that, although the average net value in negative, $E[NetValue]<0$, there might be some subpopulation defined by income where the net value is positive, $E[NetValue|Income=x]>0$, probably, higher income levels."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 864x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(12,6))\n",
    "np.random.seed(123) ## seed because the CIs from seaborn uses boostrap\n",
    "\n",
    "# pd.qcut create quantiles of a column\n",
    "sns.barplot(data=train.assign(income_quantile=pd.qcut(train[\"income\"], q=20)), \n",
    "            x=\"income_quantile\", y=\"net_value\")\n",
    "plt.title(\"Profitability by Income\")\n",
    "plt.xticks(rotation=70);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And, sadly, nope. Yet again, all levels of income have negative average net value. Although it is true that richer customers are \"less bad\" than non rich customers, they still generate, on average, negative net value. So income didn't help us much here, but what about the other variables, like region? If most of our costs come, say, from having to serve customers in far away places, we should expect that the region distinguishes the profitable from the unprofitable customers.\n",
    " \n",
    "Since region is already a categorical variable, we don't need to use quantiles here. Let's just see the average net value per region."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAt8AAAGHCAYAAABoPz7DAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8QVMy6AAAACXBIWXMAAAsTAAALEwEAmpwYAABEJ0lEQVR4nO3deVyU9fr/8ffMgMriwqZk0jEFK+2bYqhJaovkOW1qdTLztLhbWp2TZZZtp2OaZlpWWIZLHT0tepKjrfYjKzLqiBYdrUzRykwIWURQEIH794c5OTIrwj0sr+fj4WPmXq77c81wzX1fc3vPjMUwDEMAAAAA6p3V3wkAAAAAzQXNNwAAAGASmm8AAADAJDTfAAAAgElovgEAAACT0HwDAAAAJqH5BoA68PPPP2vw4MEKCQmRxWKRJHXu3FmPP/74KW/773//u2JjY92u8/LLLysgIMA+/fHHH8tisWjv3r2SpB9//FEWi0UbN2485Xw8jd1YXXzxxRo/fry/0wDQxNF8A2g2Ro8eLYvFIovFooCAAP3hD3/QbbfdpoKCglPe9uzZs5WXl6esrCzl5ORIkjIzM3X33Xfb14mNjdXf//73Ux7LmRtuuEG//PKLy+UxMTHKyclRv379JEl79+6VxWLRxx9/XC/51IXjbxiO/2vTpo169+6tFStW1Mt4a9as0YIFC+pl2wBwXOM/VQEAPhg4cKBWrVqlyspKbdmyRePHj9fPP/+sd955p8a6hmGosrJSgYGBHre7c+dO9e3bV3FxcfZ5UVFRdZq7O0FBQQoKCnK53GazKTo62rR86tLatWvVt29flZaW6vXXX9ctt9yiDh06aMiQIXU6Tnh4eJ1uDwCc4cw3gGalRYsWio6OVqdOnTRs2DD97W9/0/vvv6+ysjL75RMfffSR4uPj1bJlS61fv14lJSWaNGmSoqKi1KpVKyUkJOiDDz6wb9NisejDDz/UsmXLZLFYNHr0aEmOl51cfPHF2rVrlx577DH7mdwff/xRhmFowoQJ6tq1q4KCgtSlSxfNmDFDR44cqZH7q6++qi5duqhVq1ZKSkrSDz/8YF/m6dKPky87iYmJkSRdcsklslgs6ty5s3bv3i2r1aqMjAyH2E8++URWq1W7d+92+9ympaWpR48eatWqlfr27asvv/xSklRSUqLWrVvr1VdfrZGT1Wr1ePY9PDxc0dHRio2N1UMPPaTw8HCtX7/evryyslJ///vfdeaZZ6pVq1bq0aOHFi9e7LCNH374QUOGDFGrVq10xhlnKDk5ucZlJidPHz16VPfff79OP/10tWjRQt27d6/xGCwWixYtWqSbb75ZrVu3VkxMjJ588km3jwdA80bzDaBZCwoKUnV1tSorKyVJ1dXVuu+++zR//nxt375d/fr109ixY7V+/XqtXLlSX331lS688EJdddVV2r59uyQpJydH/fv316hRo5STk6OFCxfWGGfNmjXq3Lmz7rnnHuXk5CgnJ0cxMTEyDEMdOnTQq6++qu+++07PPPOMli9frtmzZzvE5+TkaNGiRXrjjTf06aefqqSkRMOHD5dhGLV63Mcb4zfffFM5OTnKzMxUly5ddNlllyklJcVh3SVLlmjw4MHq0qWLy+0df94WLVqkTZs2qX379rryyit1+PBhtW7dWqNGjaqx3aVLlyo2NlYXXXSRVzlXVVXp9ddfV2FhoVq0aGGfP378eK1Zs0aLFy/Wd999p0ceeUTTp0/X0qVLJR37H4xrrrlGxcXFSk9P17p16/TOO+/oq6++cjvejBkzlJKSomeeeUbbtm3TTTfdpJtuukkffvihw3qPPfaYBg0apKysLE2bNk3Tp0/XRx995NVjAtAMGQDQTNx6663G4MGD7dPffPON0aVLF6Nfv36GYRjG8uXLDUlGenq6fZ2dO3cakox33nnHYVvx8fHGmDFj7NMXXXSRMW7cOId1/vCHPxgzZ860T3ft2tV49NFHPea5YMECIzY21j796KOPGpKMnTt32ud9//33hiTj//2//2fP3Waz2Zd/9NFHhiTj559/NgzDMH744QdDkvHpp58ahmEYP//8syHJ+OijjxzGfvPNN43g4GDjwIEDhmEYRlFRkREUFGSsWrXKZb7Hn7e0tDT7vMLCQiMkJMRISUkxDMMwtmzZYkgyduzYYRiGYVRWVhqdOnUynnzySZfbPZ5zUFCQERISYthsNkOSERUVZezatcswDMPYvXu3YbFYjO+++84h9rHHHjN69uxpGIZhfPDBBzWev4KCAiMoKMjhb3bi3/DQoUNGixYtjOTkZIftDh8+3Ljkkkvs05KMO++802Gds846y7j//vtdPi4AzRtnvgE0Kx9//LFCQ0MVFBSkc889V126dKlxKUGfPn3s97/99ltJ0qBB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JKn7FUtqzGv50TSpJFctQzqo+xU0jwAAoHHx6dtOagRbrbr22mu1du3ausoHAAC/OfzWayp99UUdfus1f6cCoIny6cy3M//73/9ktZ5SDw8AQINQXVIso7hI1f5OBECT5VPzffvttztMV1RUqKKiQuPHj6/TpAAAAICmyKfm+84773SYbtmypU477TQFBwfXaVIAAABAU+RT8929e/c6T2DFihXasmWLAgIC1KFDB02ePFkhISGSpNTUVG3YsEFWq1VjxoxRr169JEm7d+9WcnKyKioqFB8frzFjxshisdR5bkBTExkZ6XALAADM5bH5fu6557xqbO+4445aJXDeeedp1KhRstlsWrlypVJTU3XTTTdp7969ysjI0IIFC1RUVKSZM2dq4cKFslqtSklJ0aRJkxQXF6cnnnhCWVlZio+Pr9X4QHMyffp0f6cAAECz5rH5jo6OrtcEevbsab/frVs3ffHFF5KkzMxMJSYmKjAwUO3bt1d0dLSys7MVFRWlsrIydevWTZI0aNAgZWZm0nwDAHyyKLHm/+ZOS22p3GKpQ1BLzXOyHABOlcfm+/rrrzcjD0nShg0blJiYKEkqLCxUXFycfVl4eLgKCwtls9kUERFhnx8REaHCwkKX20xLS1NaWpokac6cOfx3eyN32mmnyWazqX379vwtgSakobyebTab/bah5ASgafH5qwYrKyu1b98+HTx40GG+u5+Xnzlzpg4cOFBj/siRI9WnTx9J0po1a2Sz2TRw4EBJkmEYTrflar4rSUlJSkpKsk/n5+f7FI+GZerUqfb7/C2BpqOhvJ6rqqrstw0lJwCNT8eOHV0u86n53r59uxYsWKCjR4+qrKxMQUFBKi8v9/jz8g8//LDb7X788cfasmWLHnnkEfv15RERESooKLCvU1hYqPDw8BrzCwoKFB4e7svDAAAAAPzCp1/HeeWVVzR06FAtX75cQUFBWr58ua677joNGTKk1glkZWVp7dq1mj59ulq2bGmfn5CQoIyMDB09elR5eXnKyclRbGyswsLCFBQUpB07dsgwDKWnpyshIaHW4wMAAABm8enM9759+3TFFVc4zBs+fLimTJmioUOH1iqBpUuXqrKyUjNnzpQkxcXFaeLEiYqJiVH//v01depUWa1WjRs3zv5LmuPHj9eiRYtUUVGhXr168WFLAAAANAo+Nd/BwcEqKytTSEiI2rVrp7179yo0NFTl5eW1TuC5555zuezaa6/VtddeW2N+165dNX/+/FqPCQCAM3wXPoD65lPz3a9fP3311VcaMGCALr30Uj322GOy2Wzq379/feUHAIBp+C58APXNp+Z79OjR9vtXX3214uLiVFZW5vBd3QAAAACc86n53rRpk3r37q2AgGNhZ599dr0kBQAAADRFPn3byerVqzVhwgS9+OKL2rZtW33lBAAAADRJPp35njdvnvbu3auNGzdq8eLFOnr0qBITEzVgwAB16dKlvnIEAAAAmgSL4etPRp5gx44dWrVqlbZu3ao33nijLvOqN/v27fN3CgDQLEzM2Oj1ui8lDqjHTADAXHX2C5fH5efnKyMjQxs3btT+/ft1ySWX1Do5AAAAoLnwqflev369Nm7cqJ9++knx8fH685//7PABTAAAAACu+dQ1b9myRZdddpn69u2rVq1a1VdOAAAAQJPk07edzJgxQ4MGDXLbeN9zzz2nnBQAAADQFPnUfHtj//79db1JAAAAoEmo8+bbYrHU9SYBAACAJqHOm28AAAAAztF8AwAAACap8+b7FH6zBwAAAGjSfGq+161b53T+22+/bb8/ceLEU8sIAAAAaKJ8ar7ffPNNj/MHDOAnggEAAABnvPqRnW3btkmSqqur7feP+/XXXxUUFFT3mQEAAABNjFfN9wsvvCBJqqiosN+Xjn2tYNu2bTV27Nj6yQ4AAABoQrxqvpOTkyVJzz//vO644456TQgAAABoqny65vuOO+5QZWWlvvvuO2VkZEiSysvLVV5eXi/JAQAAAE2JV2e+j9uzZ4/mzp2rwMBAFRQUKDExUd9++60++eQT3X333fWVIwAAANAk+HTmOyUlRTfccIOeeeYZBQQc69u7d++u7du310tyAAAAQFPiU/O9d+9eDRw40GFeq1atVFFRUadJAQAAAE2RT813VFSUdu/e7TAvOztb0dHRdZoUAAAA0BT5dM33DTfcoDlz5uiyyy5TZWWlUlNT9cEHH+i2226rr/wAAACAJsOnM9/nn3++ZsyYoYMHD6p79+7Kz8/XtGnT1LNnz/rKDwAAAGgyfGq+KysrtWvXLhmGodDQUB05ckTvvvuunn/++frKDwAAAGgyfLrs5Pnnn9dPP/2k888/X+3ataunlAAAAICmyafm++uvv9bzzz+vkJCQ+soH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x7Vt21ZFRUWSpKKiohofJqlrH3/8sbZs2aK77rrL5zeBAwYM8Oq/un799Vfl5eVp2rRpmjJligoKCjR9+nQdOHDAbVy7du1ktVpltVo1ePBg7dq1y+NY4eHh6tevnywWi2JjY2W1WlVSUuLV46mqqtKmTZu8/h+ATz75xP6a6t+/v8faPe7000/XQw89pLlz5+rCCy9Uhw4daqzj7HXrqTZq81p3FeOpLjyN5aw2To7xti6cjeWpNpzFeKoNV4/JU104i/NUG85ivKmL407cN3u7z/B2f+4uxtv9haux3O0zjsdkZmZ6vb84cRxf9hcnxnm7zzj5MXm7vzgxztt9xokx7urC1bHXU03U5pjtLsZVXXgzjrOacBb33HPPua0LV2O5qwtXMZ5qwt3jclUXrmI81YSrOF/2F8c168tOunbtqpycHOXl5Sk8PFwZGRm666676mUswzD04osv6vTTT9dVV13lVczBgwdls9kUEhKiiooKbd26VcOGDXMbM2rUKI0aNUqS9M033+itt97y6jGVl5fLMAwFBQWpvLxc//vf//TnP//ZbUy7du0UERGhffv2qWPHjtq6das6derk1WOTfDuzGRkZqZ07d+rIkSNq0aKFtm7d6tUlJMXFxWrbtq3y8/O1adMmry9HkKSEhAR98sknGj58uD755BP16dPH61hfZWVlae3atXrsscfUsmVLr2JycnLsbyY2b97s8VpzSTrjjDO0ZMkS+/SUKVP0xBNPeHxjUVRUZH9jumnTJsXExHgcq0+fPtq2bZt69Oihffv2qbKyUq1bt/YYJx17s9WxY0eHy8LcCQ8P17fffqsePXpo27Ztio6O9irueH1UV1drzZo1uuyyyxyWu3rduquN2rzWXcV4qgtXce5qw1mMN3Xhaix3teEqxl1tuHv+3NWFqzh3teEqxlNduNo3u6uL2uzPXcV4qgtXce7qwlWMu7pwFeNpf+EqrlWrVi7rwt3z564uXMW5qwtXMe7qwtWxd8WKFW6PI7U5ZruKcVcXrmI8HUecxd17770O65xcF67GclcXrmI++OADt8cRd8+fq7pwFXP33Xe7PY64ivO0v3CmWTffNptNY8eO1axZs1RdXa1LLrnEq6bimWee0bfffquSkhLddtttGjFihP1Dh658//33Sk9P1xlnnKFp06ZJcv41OycqKipScnKyqqurZRiG+vfvr/PPP9+3B+ml4uJiPfXUU5KOvVscMGCAevXq5TFu7NixevbZZ1VZWan27dtr8uTJXo135MgR/e9//9PEiRO9Wj8uLk4XXHCBpk+fLpvNps6dO3v1q1Lz589XSUmJAgICNG7cOJfXKTv7mw4fPlxPP/20NmzYoMjISE2dOtVjTGhoqJYtW6aDBw9qzpw56ty5sx588EGPcampqaqsrNTMmTPtj/fE58ZZzJdffqmcnBxZLBZFRkY6fS5rU6vOYr755hv9+OOPslgsioqKqjGWq3EWLVqke+65RwEBAZoyZUqNM3Su4ty9MXMWM2nSJPtXhgYGBmrSpElexZWXl2v9+vWSpL59++qSSy5xiHH1unVXG65iKisrXdaGq5jly5e7rQtXcRs2bHBZG7XZF7mL++yzz1zWhqsYd7XhLj93deEqzl1tuIrJzc11Wxeu9s3dunVzWReuYjZt2uSyLlzF3HnnnW7rwlXcU0895bIuanO8cRXz3HPPud1fuIqrrKx0WRfu8nNXF67iQkJCXNaFq5h3333XbV044+k44oq7unBl6dKlbuvCmX/9618ejyN1ZeXKlW7rwhlvjiOu+HKCT5JXxxFX4/haF/zCJQAAAGCSZn3NNwAAAGAmmm8AAADAJDTfAAAAgElovgEAAACT0HwDAAAAJqH5BgC4lZ+fr5tvvlnV1dX+TgUAGj2+ahAAAAAwCWe+AaAZqKqq8ncKAAA181+4BICmbMqUKbrsssu0ceNG7du3T4888ohWrlypvXv3KioqSqNHj1aPHj0kSXl5eUpOTtYPP/yguLg4nXbaaTp8+LDuuusu5eXl6Y477tBrr70mm82mwsJCpaSkaPv27QoNDdWwYcPsvzi7atUq7d27Vy1atNCmTZsUGRmpKVOmqGvXrv58KgCgweDMNwA0YZ999pnuv/9+Pf/883ryySd17bXXatmyZbr55ps1f/58HTx4UJK0cOFCde3aVcuWLdP111+vTz/91OU2Fy5cqIiICC1evFj33HOPXnvtNW3dutW+fMuWLUpMTNTLL7+shIQELVu2rN4fJwA0FjTfANCEXX755YqMjFR6erri4+PVu3dvWa1WnXfeeeratau+/PJL5efna9euXbrhhhsUEBCgs88+W+eff77T7eXn52v79u36y1/+ohYtWqhz584aPHiw0tPT7eucffbZ9nEGDRqkH3/80aRHCwANH5edAEATFhkZKelY0/zFF19oy5Yt9mVVVVXq0aOHCgsLFRoaqpYtWzrE5efn19heUVGRQkNDFRQU5LDurl277NNt27a132/RooWOHj2qqqoq2Wy2On1sANAY0XwDQDMQERGhgQMH6rbbbquxbP/+/SotLdWRI0fsDbizxluSwsLCVFpaqrKyMnsDnp+fr/Dw8PpLHgCaEC47AYBmYODAgdqyZYuysrJUXV2tiooKffPNNyooKFBUVJS6du2q1atXq7KyUjt27HA4Q36iyMhInXXWWXr11VdVUVGhn376SR999JEGDhxo8iMCgMaJM98A0AxERkbqvvvu08qVK7Vw4UJZrVbFxsZqwoQJkqQ777xTixYt0tixYxUbG6vExESXP6rz17/+VSkpKZo0aZJCQ0N1/fXX67zzzjPz4QBAo8WP7AAAanj66ad1+umna8SIEf5OBQCaFC47AQAoOztbubm5qq6uVlZWljZv3qw+ffr4Oy0AaHK47AQAoAMHDmj+/PkqKSlRRESExo8frzPPPNPfaQFAk8NlJwAAAIBJuOwEAAAAMAnNNwAAAGASmm8AAADAJDTfAAAAgElovgEAAACT0HwDAAAAJvn/HG+mxh/K/JsAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 864x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(12,6))\n",
    "np.random.seed(123)\n",
    "region_plot = sns.barplot(data=train, x=\"region\", y=\"net_value\")\n",
    "plt.title(\"Profitability by Region\");"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Bingo! We can clearly see that some regions are profitable, like regions 2, 17, 39, and some are not profitable, like regions 0, 9, 29 and the especially bad region 26. This is looking super promising! We can take this and transform into a policy: only do business with the regions that showed to be profitable *according to the data that we have here*. \n",
    " \n",
    "One thing to notice is that what we are doing is what ML would do, but in a much simpler way. Namely, we are estimating the expected value of net value in each region: $E[NetValue|Region]$. Now, we need to take this estimation and do something with it.\n",
    " \n",
    "To construct this policy, we will do something very simple. We will construct a 95% confidence interval around the expected net value of a region. If it is greater than zero, we will do business with that region\n",
    " \n",
    "The following code builds a dictionary where the key is the region and the value is the lower bound of the 95% CI. Then, the dictionary generator filters only those regions where the expected net value is positive. The result is the regions we will do business with according to our policy."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{1: 2.9729729729729737,\n",
       " 2: 20.543302704837856,\n",
       " 4: 10.051075065003388,\n",
       " 9: 32.08862469914759,\n",
       " 11: 37.434210420891255,\n",
       " 12: 37.44213667009523,\n",
       " 15: 32.09847683044394,\n",
       " 17: 39.52753893574483,\n",
       " 18: 41.86162250217046,\n",
       " 19: 15.62406327716401,\n",
       " 20: 22.06654814414531,\n",
       " 21: 24.621030401718578,\n",
       " 25: 33.97022928360584,\n",
       " 35: 11.68776141117673,\n",
       " 37: 27.83183541449011,\n",
       " 38: 49.740709395699994,\n",
       " 45: 2.286387928016998,\n",
       " 49: 17.01853709535029}"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# extract the lower bound of the 95% CI from the plot above\n",
    "regions_to_net = train.groupby('region')['net_value'].agg(['mean', 'count', 'std'])\n",
    "\n",
    "regions_to_net = regions_to_net.assign(\n",
    "    lower_bound=regions_to_net['mean'] - 1.96*regions_to_net['std']/(regions_to_net['count']**0.5)\n",
    ")\n",
    "\n",
    "regions_to_net_lower_bound = regions_to_net['lower_bound'].to_dict()\n",
    "regions_to_net = regions_to_net['mean'].to_dict()\n",
    "\n",
    "# filters regions where the net value lower bound is > 0.\n",
    "regions_to_invest = {region: net \n",
    "                     for region, net in regions_to_net_lower_bound.items()\n",
    "                     if net > 0}\n",
    "\n",
    "regions_to_invest"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`regions_to_invest` has all the regions we will engage with. Lets now see how this policy would have performed in our test set, the one we pretend not to have. This is a key step in evaluating our policy, because it could very well be that, simply by chance, a region in our training set is appearing to be profitable. If that is only due to randomness, it will be unlikely that we will find that same pattern in the test set.\n",
    " \n",
    "To do so, we will filter the test set to contain only the customers in the regions defined as profitable (according to our training set). Then, we will plot the distribution of net income for those customers and also show the average net income of our policy."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "region_policy = (test[test[\"region\"]\n",
    "                      # filter regions in regions_to_invest\n",
    "                      .isin(regions_to_invest.keys())]) \n",
    "\n",
    "sns.histplot(data=region_policy, x=\"net_value\")\n",
    "# average has to be over all customers, not just the one we've filtered with the policy\n",
    "plt.title(\"Average Net Income: %.2f\" % (region_policy[\"net_value\"].sum() / test.shape[0]));"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Machine Learning Models as Policy Inputs\n",
    " \n",
    "If you are willing to do even better, we can now use the power of machine learning. Keep in mind that this might add tones of complexity to the whole thing and usually only marginal gains. But, depending on the circumstances, marginal gains can be translated into huge piles of money and that's why machine learning is so valuable these days.\n",
    " \n",
    "Here, I'll use a Gradient Boosting model. It's a fairly complicated model to explain, but one that is very simple to use. For our purpose, we don't need to get into the details of how it works. Instead, just remember what we've seen in our ML Crash course: a ML model is a super powerful predictive machine that has some complexity parameters. It's a tool to estimate $E[Y|X]$. The more complex, the more powerful the model becomes. However, if the complexity is too high, the model will overfit, learn noise and not generalize well to unseen data. Hence, we need to use cross validation here to see if the model has the right complexity. \n",
    " \n",
    "Now, we need to ask, how can good predictions be used to improve upon our simple region policy to identify and engage with profitable customers? I think there are two main improvements that we can make here. First, you will have to agree that going through all the features looking for one that distinguishes good from bad customers is a cumbersome process. Here, we had only 3 of them (age, income and region), so it wasn't that bad, but imagine if we had more than 100. Also, you have to be careful with issues of [multiple testing](https://en.wikipedia.org/wiki/Multiple_comparisons_problem) and false positive rates. The second reason is that it is probably the case that you need more than one feature to distinguish between customers. In our example, we believe that features other than region also have some information on customer profitability. Sure, when we looked at income alone it didn't give us much, but what about income in those regions that are just barely unprofitable? Maybe, in those regions, if we focus only on richer customers, we could still get some profit. Technically speaking, we are saying that $E[NetValue|Region, Income, Age]$ is a better predictor of `NetValue` than $E[NetValue|Region]$. This makes a lot of sense. Using more information about income and age on top of region should allow us to predict net value better. \n",
    " \n",
    "Coming up with these more complicated policies that involve interacting more than one feature can be super complex. The combinations we have to look at grow exponentially with the number of features and it is simply not a practical thing to do. Instead, what we can do is throw all those features into a machine learning model and have it learn those interactions for us. This is precisely what we will do next.\n",
    " \n",
    "The goal of this model will be to predict `net_value` using `region`, `income`, `age`. To help it, we will take the region feature, which is categorical, and encode it with a numerical value. We will replace each region by the region's average net value on the training set. Remember that we have those stored in the `regions_to_net` dictionary? With this, all we have to do is call the method `.replace()` and pass this dictionary as the argument. I'll create a function for this, because we will do this replacement multiple times. This process of transforming features to facilitate learning is generally called feature engineering."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "def encode(df): \n",
    "    return df.replace({\"region\": regions_to_net})"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Next, our model will be imported from [Sklearn](https://scikit-learn.org/stable/). All their models have a pretty standard usage. First, you instantiate the model passing in the complexity parameters. For this model, we will set the number of estimators to 400, the max depth to 4 and so on. The deeper the model and the greater the number of estimators, the more powerful the model will be. Of course, we can't let it be too powerful, otherwise it will learn the noise in the training data or overfit to it. Again, you don't need to know the details of what these parameters do. Just keep in mind that this is a very good prediction model. Then, to train our model, we will call the `.fit()` method, passing the features `X` and the variable we want to predict - or target variable - `net_value`. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [],
   "source": [
    "model_params = {'n_estimators': 400,\n",
    "                'max_depth': 4,\n",
    "                'min_samples_split': 10,\n",
    "                'learning_rate': 0.01,\n",
    "                'loss': 'ls'}\n",
    "\n",
    "features = [\"region\", \"income\", \"age\"]\n",
    "target = \"net_value\"\n",
    "\n",
    "np.random.seed(123)\n",
    "\n",
    "reg = ensemble.GradientBoostingRegressor(**model_params)\n",
    "\n",
    "# fit model on the training set\n",
    "encoded_train = train[features].pipe(encode)\n",
    "reg.fit(encoded_train, train[target]);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The model is now trained. Next, we need to check if it is any good. To do this, we can look at the predictive performance of this model **on the test set**. There are tons of metrics to evaluate the predictive performance of a machine learning model. Here, I'll use one which is called $R^2$. We don't need to get into much detail here. It suffices to say that the $R^2$ is used to evaluate models that predict a continuous variable (like `net_income`). Also, $R^2$ can go from minus infinity (it will be negative if the prediction is worse than the average) to 1.0. The $R^2$ tells us how much of the variance in `net_income` is explained by our model."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Train R2:  0.7108790300152951\n",
      "Test R2:  0.6938513063048141\n"
     ]
    }
   ],
   "source": [
    "train_pred = (encoded_train\n",
    "              .assign(predictions=reg.predict(encoded_train[features])))\n",
    "\n",
    "print(\"Train R2: \", r2_score(y_true=train[target], y_pred=train_pred[\"predictions\"]))\n",
    "print(\"Test R2: \", r2_score(y_true=test[target], y_pred=reg.predict(test[features].pipe(encode))))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In this case, the model explains about 71% of the `net_income` variance in the training set but only about 69% of the `net_income` variance in the test set. This is expected. Since the model had access to the training set, the performance there will often be overestimated. Just for fun (and to learn more about overfitting), try setting the 'max_depth' of the model to 14 and see what happens. You will likely see that the train $R^2$ skyrockets but the test set $R^2$ gets lower. This is what overfitting looks like. \n",
    " \n",
    "Next, in order to make our policy, we will store the test set predictions in a `prediction` column. This predictions are estimates of $E[NetValue|Age, Income, Region ]$."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>customer_id</th>\n",
       "      <th>region</th>\n",
       "      <th>income</th>\n",
       "      <th>age</th>\n",
       "      <th>net_value</th>\n",
       "      <th>prediction</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>5952</th>\n",
       "      <td>5952</td>\n",
       "      <td>19</td>\n",
       "      <td>1983</td>\n",
       "      <td>23</td>\n",
       "      <td>21</td>\n",
       "      <td>47.734883</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1783</th>\n",
       "      <td>1783</td>\n",
       "      <td>31</td>\n",
       "      <td>914</td>\n",
       "      <td>31</td>\n",
       "      <td>-46</td>\n",
       "      <td>-36.026935</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4811</th>\n",
       "      <td>4811</td>\n",
       "      <td>33</td>\n",
       "      <td>1349</td>\n",
       "      <td>25</td>\n",
       "      <td>-19</td>\n",
       "      <td>22.553420</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>145</th>\n",
       "      <td>145</td>\n",
       "      <td>20</td>\n",
       "      <td>1840</td>\n",
       "      <td>26</td>\n",
       "      <td>55</td>\n",
       "      <td>48.306256</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7146</th>\n",
       "      <td>7146</td>\n",
       "      <td>19</td>\n",
       "      <td>3032</td>\n",
       "      <td>34</td>\n",
       "      <td>-17</td>\n",
       "      <td>7.039414</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "      customer_id  region  income  age  net_value  prediction\n",
       "5952         5952      19    1983   23         21   47.734883\n",
       "1783         1783      31     914   31        -46  -36.026935\n",
       "4811         4811      33    1349   25        -19   22.553420\n",
       "145           145      20    1840   26         55   48.306256\n",
       "7146         7146      19    3032   34        -17    7.039414"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "model_policy = test.assign(prediction=reg.predict(test[features].pipe(encode)))\n",
    "\n",
    "model_policy.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Just like we did with the `regions` feature, we can show the average net value by predictions of our model. Since the model is continuous and not categorical, we need to make it discrete first. One way of doing so is using pandas `pd.qcut` (by golly! I love this function!), which partitions the data into quantiles using the model prediction. Let's use 50 quantiles because 50 is the number of regions that we had. And just as a convention, I tend to call these model quantiles **model bands**, because it gives the intuition that this group has model predictions within a band, say, from -10 to 200. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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338rDPGQbXfBggVq1d3a2rrRYUr3O1ZGRkY4dOgQcnNz0a9fP8yaNQtvvfWW3HAciUSCAwcOYNq0aViyZAm6deuG8ePH4++//0aXLl2aXefmGjZsGE6ePIno6GgMHjwYHh4eeOutt9CuXTtxzPYbb7yB119/HW+99RY8PT1x/vx5/Oc//2l0u71790ZISAiys7MxZMgQeHp64osvvoC2tjYAYMqUKXj22Wcxfvx42NjYqJxqcfXq1XjppZfw5ptvomfPnti5cyd27tyJESNGPPC+f/TRR/jtt99w8uRJ9O/fH507d0ZgYCACAwOxf/9+sa4A8MUXX6BXr14YPXo0xo4dC39/f7nrTaytrbFz504cP34cPXv2xDvvvIMvvvhCrTH769atw+XLl9G5c2fY2Ng0KcbAwACnT5+Gj48PAgMD0bVrV0ybNg0XL15Ex44dAQCmpqZYv349BgwYgN69e2Pv3r3YvXs33N3dm11HoieVRHgYg0KJiDTc5s2b8Z///AdpaWlNGi7UVIcOHcKUKVOQkpIijiEmUqW8vBxTpkzBzZs3ERISgs6dO7d1lYhIw7BnnYieKCUlJYiKisIXX3yB1157rcUS9bKyMty8eRP//e9/MXPmTCbq1CSGhoY4cOAA/vWvf9335llE9GRizzoRPVHmzp2LX3/9FSNHjsSff/4pN5b7QXz44Yf4+OOP0a9fP+zbt6/Js8AQERE1hsk6EREREZGG4jAYIiIiIiINxWSdiIiIiEhDPXF3MK1/gwkiIiIiopZW/8ZgD4o960REREREGorJOhERERGRhmKyTkRERESkoZisExERERFpKCbrREREREQaisk6EREREZGGYrJORERERKShmKwTEREREWkoJutERERERBqKyToRERERkYZisk5EREREpKGYrBMRERERaSidtq4AEREREVFL+Oyzz5CTkwNra2u89957j0VZTNaJiIiI6LGQk5ODzMzMx6osjUnWN2/ejCtXrsDMzAzr1q0DAJSUlODLL79EdnY2bGxs8NZbb8HExAQAsHfvXpw8eRJaWloIDAyEp6dnG9aeiIiIiKjlacyY9aFDh2LZsmVyy/bt24fevXtj48aN6N27N/bt2wcASE1NRVhYGNavX4/ly5dj69atkEqlbVBrIiIiInqUffbZZ1i6dCk+++yztq6KUhqTrPfo0UPsNZeJ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6Vom7WE6tenzpfNiUSIiIqKHQ2MvMCUiIiIietIxWSciIiIi0lBM1omIiIiINBSTdSIiIiIiDcVknYiIiIhIQzFZJyIiIiLSUJy68TG19lwecspqYW2kjaUDLdu6OkRERESkBibrj6mcslrcK61tVgxvbkRERESkWZisk4g3NyIiIiLSLByzTkRERESkoZisExERERFpKCbrREREREQaisk6EREREZGG4gWmj4A1oTeQU1YFayM9vD+4e1tXh4iIiIhaCZP1R0BOWRUySyoafY7202vlHkvClwKlmZC0s1FYR0RERESPBrWGwUilUuTn57d0XYiIiIiIqJ5m9ayXlpbihx9+QHh4OHR0dPDzzz/j0qVLSEhIwIwZMx5WHYmIiIiInkjN6lkPCgqCkZERNm/eDB2dujy/a9euCAsLeyiVIyIiIiJ6kjWrZz06OhrfffedmKgDgKmpKQoLC1u8YkRERERET7pm9awbGRmhuLhYbllOTg4sLCxatFJERERERNTMZH3EiBFYt24dYmJiIAgC4uLisGnTJowcOfJh1Y+IiIiI6InVrGEwkydPhq6uLrZu3Yra2lps2bIFAQEBGDdu3MOqHxERERHRE6tZybpEIsH48eMxfvz4h1Wfx9qnZy4iu6wMNkZG+MC/X1tXh4iIiIg0XLOS9ZiYGJXrevXq9cCVedxll5Uhs6Ss0ecIU15TXHhuKVCSCZiYK1+vhLW1tdxfIiIiInr0NCtZ37Jli9zjoqIi1NTUwMrKCt98802LVowezHvvvdfWVSAiIiKiB9SsZH3Tpk1yj6VSKXbv3g1DQ8MWrRQRERERETVzNhiFYC0tTJs2Dfv372+p+hARERER0f97oGQdAK5duwYtrQfeDBERERERNdCsYTCvvPKK3OOqqipUVVVhwYIFLVopIiIiIiJqZrK+ePFiucf6+vqwt7eHkZFRi1aKiIiIiIiamaz36NHjYdWDiIiIiIgauG+y/vXXX0Mikdx3Q6+91rT5v58ktZOfl19w9gpQUgaYmCquIyIiIiJq4L7Jup2dXWvUgxrBGxwRERERPZnum6w/++yzrVEPagRvcERERET0ZGrWmHUAqKmpQXp6OoqKiuSW9+rVq8UqRUREREREzUzWb968ifXr16O6uhrl5eUwNDRERUUFrKys8M033zysOhIRERERPZGadTejHTt2YNKkSdi2bRsMDQ2xbds2PP300xg1atTDqh8RERER0ROrWT3r6enpGDdunNyyKVOm4F//+hcmTZqkVgV+/vlnXL58GTo6Omjfvj1effVVGBsbAwD27t2LkydPQktLC4GBgfD09AQAJCUlYdOmTaiqqoKXlxcCAwObNGMNEREREdGjpFk960ZGRigvLwcAmJubIzU1FSUlJaioqFC7Ah4eHli3bh2++OIL2NvbY+/evQCA1NRUhIWFYf369Vi+fDm2bt0KqVQKAAgKCsKiRYuwceNGZGZmIioqSu3yiYiIiIg0VbOS9f79+yMyMhIAMHz4cHz00Ud4//33MWDAALUr0KdPH2hrawMAunbtiry8PABAREQE/Pz8oKurC1tbW9jZ2SEhIQH5+fkoLy9H165dIZFI4O/vj4iICLXLb03W1taws7PjFIxERERE1CTNGgYzd+5c8f8TJ06Em5sbysvL0adPnxapzMmTJ+Hn5wcAyMvLg5ubm7jO0tISeXl50NbWhpWVlbjcyspKTPCVCQ4ORnBwMABgzZo1zaqPLKkuVCNGmbVr1zarfCIiIiJ6sjUrWb948SK8vb2ho1MX1q1btybFrVq1CgUFBQrLZ8yYgb59+wIA9uzZA21tbQwePBgAIAiC0m2pWq5KQEAAAgICmhUjk5OTAwDQVSOGiIiIiJ5MDg4OLbatZiXrf/zxB7Zs2YL+/ftj0KBBTZ5bfcWKFY2uDwkJweXLl/Gf//xHvFDUysoKubm54nPy8vJgaWmpsDw3NxeWlpbN2Q0iIiIiokdCs8asr127FqtWrYK5uTm+++47vPzyy/jpp5+QlJSkdgWioqKwf/9+vPfee9DX1xeX+/j4ICwsDNXV1cjKykJGRgZcXV1hYWEBQ0NDxMXFQRAEnDlzBj4+PmqXT0RERESkqSRCc8eV1BMXF4ddu3YhOjoav//+u1rbWLx4MWpqamBiYgIAcHNzw8KFCwHUDY05deoUtLS0MHfuXHh5eQEAEhMTsXnzZlRVVcHT0xPz5s1r8tSN2Vt2Nrlu1ZOHAwB0D/zV9JhJE5r8XCIiIiJ6/LTkMBi1kvWcnByEhYXh7NmzyM7ORv/+/fHyyy+3WKUeJibrRERERPQwtdmY9aNHj+Ls2bO4c+cOvLy88Mwzz8hdcPokWX0mBNmlpbAxNsZy/6FtXR0iIiIiegw1K8u+fPkyRo4ciX79+sHAwOBh1emRkF1aisySkrauBhERERE9xpp1gemyZcvg7+/faKL+9ttvP3CliIiIiIiomcl6U2RnZ7f0JomIiIiInkgtnqw3dVYWIiIiIiJqXIsn60RERERE1DKYrBMRERERaagWT9Yf4B5LRERERERUT7OS9QMHDihd/tdf/9w0SHb3USIiIiIiejDNStZ379593+WDBg16sBoRERERERGAJt4UKSYmBgAglUrF/8vcu3cPhoaGLV8zIiIiIqInXJOS9S1btgAAqqqqxP8DddM0mpmZYd68eQ+ndhqietIExYWhp4GSEsDERPl6IiIiIqIH1KRkfdOmTQCAb775Bq+99tpDrRAREREREdVp1pj11157DTU1Nbhx4wbCwsIAABUVFaioqHgolSMiIiIiepI1qWddJiUlBZ999hl0dXWRm5sLPz8/XL9+HadPn8Zbb731sOpIRERERPREalbPelBQEKZPn46vvvoKOjp1eX6PHj1w8+bNh1I5IiIiIqInWbOS9dTUVAwePFhumYGBAaqqqlq0UkRERERE1Mxk3cbGBklJSXLLEhISYGdn16KVIiIiIiKiZo5Znz59OtasWYORI0eipqYGe/fuxbFjx/Dyyy8/rPoRERERET2xmtWz/tRTT2HZsmUoKipCjx49kJOTg6VLl6JPnz4Pq35ERERERE+sZiXrNTU1SExMhCAIMDExQWVlJQ4dOoRvvvnmYdWPiIiIiOiJ1axhMN988w3u3LmDp556Cubm5g+pSkREREREBDQzWb969Sq++eYbGBsbP6z6EBERERHR/2vWMBhra2tUV1c/rLoQEREREVE9zepZ9/f3x9q1azF27FiFYTC9evVqyXoRERERET3xmpWsHzlyBADw22+/yS2XSCRP3EWm1tbWcn+JiIiIiFqaRBAEoa0r0Zqyt+xs8nOrJw9/iDUhIiIioseRg4NDi22rWWPWiYiIiIio9TBZJyIiIiLSUEzWiYiIiIg0FJN1IiIiIiINxWSdiIiIiEhDMVknIiIiItJQTNaJiIiIiDQUk3UiIiIiIg3FZJ2IiIiISEMxWSciIiIi0lBM1omIiIiINBSTdSIiIiIiDaXT1hX43//+h0uXLkEikcDMzAyvvvoqLC0tAQB79+7FyZMnoaWlhcDAQHh6egIAkpKSsGnTJlRVVcHLywuBgYGQSCRtuBdERERERC2vzXvWJ02ahC+++AJr166Ft7c3/vzzTwBAamoqwsLCsH79eixfvhxbt26FVCoFAAQFBWHRokXYuHEjMjMzERUV1YZ7QERERET0cLR5sm5kZCT+v7KyUuwhj4iIgJ+fH3R1dWFraws7OzskJCQgPz8f5eXl6Nq1KyQSCfz9/REREdFW1SciIiIiemjafBgMAPz22284c+YMjIyMsHLlSgBAXl4e3NzcxOdYWloiLy8P2trasLKyEpdbWVkhLy9P5baDg4MRHBwMAFizZk2z6mVtbd2s5xMRERERtaRWSdZXrVqFgoICheUzZsxA37598fzzz+P555/H3r17ceTIETz33HMQBEHptlQtVyUgIAABAQHqVBs5OTlqxRERERHRk8vBwaHFttUqyfqKFSua9LxBgwZhzZo1eO6552BlZYXc3FxxXV5eHiwtLRWW5+bmihekEhERERE9Ttp8zHpGRob4/0uXLonfRHx8fBAWFobq6mpkZWUhIyMDrq6usLCwgKGhIeLi4iAIAs6cOQMfH5+2qj4RERER0UPT5mPWf/nlF2RkZEAikcDa2hoLFy4EADg5OWHAgAFYsmQJtLS0MH/+fGhp1X23WLBgATZv3oyqqip4enrCy8urLXeBiIiIiOihkAjNHQT+iMvesrPJz62ePPwh1oSIiIiIHkctOWa9zYfBEBERERGRckzWiYiIiIg0FJN1IiIiIiINxWSdiIiIiEhDMVknIiIiItJQTNaJiIiIiDQUk3UiIiIiIg3FZJ2IiIiISEMxWSciIiIi0lBM1omIiIiINBSTdSIiIiIiDcVknYiIiIhIQzFZJyIiIiLSUEzWiYiIiIg0FJN1IiIiIiINxWSdiIiIiEhDMVknIiIiItJQTNaJiIiIiDQUk3UiIiIiIg3FZJ2IiIiISEMxWSciIiIi0lBM1omIiIiINBSTdSIiIiIiDcVknYiIiIhIQzFZJyIiIiLSUEzWiYiIiIg0FJN1IiIiIiINxWSdiIiIiEhDMVknIiIiItJQTNaJiIiIiDQUk3UiIiIiIg3FZJ2IiIiISEMxWSciIiIi0lBM1omIiIiINBSTdSIiIiIiDcVknYiIiIhIQzFZJyIiIiLSUEzWiYiIiIg0FJN1IiIiIiINpdPWFZA5cOAAdu7ciR9++AGmpqYAgL179+LkyZPQ0tJCYGAgPD09AQBJSUnYtGkTqqqq4OXlhcDAQEgkkjasPRERERFRy9OInvWcnBxER0fD2tpaXJaamoqwsDCsX78ey5cvx9atWyGVSgEAQUFBWLRoETZu3IjMzExERUW1Uc2JiIiIiB4ejUjWd+zYgVmzZsn1jkdERMDPzw+6urqwtbWFnZ0dEhISkJ+fj/LycnTt2hUSiQT+/v6IiIhow9oTERERET0cbT4M5tKlS7C0tESnTp3klufl5cHNzU18bGlpiby8PGhra8PKykpcbmVlhby8PJXbDw4ORnBwMABgzZo1zapb/Z5+IiIiIqLW1irJ+qpVq1BQUKCwfMaMGdi7dy/+/e9/K6wTBEHptlQtVyUgIAABAQHNipHJyclRK46IiIiInlwODg4ttq1WSdZXrFihdHlKSgqysrKwdOlSAEBubi7ee+89fPrpp7CyskJubq743Ly8PFhaWiosz83NhaWl5cPdASIiIiKiNtCmY9adnZ3xww8/YNOmTdi0aROsrKzw2WefwdzcHD4+PggLC0N1dTWysrKQkZEBV1dXWFhYwNDQEHFxcRAEAWfOnIGPj09b7gYRERER0UPR5mPWVXFycsKAAQOwZMkSaGlpYf78+dDSqvtusWDBAmzevBlVVVXw9PSEl5dXG9eWiIiIiKjlSYTmDgJ/xGVv2dnk51ZPHv4Qa0JEREREj6OWHLOuEVM3EhERERGRIibrREREREQaisk6EREREZGGYrJORERERKShmKwTEREREWkoJutERERERBqKyToRERERkYZisk5EREREpKGYrBMRERERaSgm60REREREGorJOhERERGRhmKyTkRERESkoZisExERERFpKCbrREREREQaisk6EREREZGGYrJORERERKShmKwTEREREWkoJutERERERBqKyToRERERkYZisk5EREREpKGYrBMRERERaSgm60REREREGorJOhERERGRhmKyTkRERESkoZisExERERFpKCbrREREREQaisk6EREREZGGYrJORERERKShdNq6Am1t9ZmjyC4rgY2RCZb7j27r6hARERERiZ74ZD27rASZJUVtXQ0iIiIiIgUcBkNEREREpKGYrBMRERERaSgm60REREREGorJOhERERGRhmKyTkRERESkoZisExERERFpKCbrREREREQaisk6EREREZGGeuJuilQ9ebj8grOHgZIiwMRI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\n",
      "text/plain": [
       "<Figure size 864x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(12,6))\n",
    "\n",
    "n_bands = 50\n",
    "bands = [f\"band_{b}\" for b in range(1,n_bands+1)]\n",
    "\n",
    "np.random.seed(123)\n",
    "model_plot = sns.barplot(data=model_policy\n",
    "                         .assign(model_band = pd.qcut(model_policy[\"prediction\"], q=n_bands)),\n",
    "                         x=\"model_band\", y=\"net_value\")\n",
    "plt.title(\"Profitability by Model Prediction Quantiles\")\n",
    "plt.xticks(rotation=70);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here, notice how there are model bands where the net value is super negative, while there are also bands where it is very positive. Also, there are bands where we don't know exactly if the net value is negative or positive. Finally, notice how they have an upward trend, from left to right. Since we are predicting net value, it is expected that the prediction will be proportional to what it predicts.\n",
    "\n",
    "Now, to compare this policy using a machine learning model with the one using only the regions we can also show the histogram of net gains, along with the total net value in the test set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [
    {
     "data": {
      "image/png": "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BnDvFhCFhYWVEFnNVPxcUXd3d4fqMTkjIiKqJiRJMt11vzLwMLJr8LAmERERkYwwOSMiIiKSESZnRERERDLC5IyIiIhIRpicEREREckIkzMiIiIiGWFyRkRERCQjTM6IiIiIZITJGREREZGMMDkjIiIikhEmZ0REREQywuSMiIiISEaYnBERERHJCJMzIiIiIhlhckZEREQkI0zOiIiIiGSEyRkRERGRjDA5IyIiIpIRlasDoJpFIUm4m+dYHY2bBJXaWDUBERERyQyTM3IqXZHAr8dyHarTIsoHKnUVBURERCQzPKxJREREJCNMzoiIiIhkhMkZERERkYwwOSMiIiKSESZnRERERDLC5IyIiIhIRpicEREREckIkzMiIiIiGWFyRkRERCQjTnlCwPLly3H06FH4+fkhISEBALBhwwbs2LEDvr6+AIAhQ4agVatWAIBNmzZh586dUCgUGD16NFq0aOGMMImIiIhczinJWdeuXdGrVy8sW7bMbH6fPn3w9NNPm827fPky9u/fj0WLFiE7OxsLFizABx98AIWCg3xERERU/Tkl44mMjIS3t7ddZZOSktChQweo1WrUrl0bdevWxfnz56s4QiIiIiJ5cOmDz7dt24Y9e/agQYMGGDlyJLy9vZGVlYVGjRqZygQGBiIrK8uFURIRERE5j8uSsx49emDAgAEAgPXr12PNmjWYOHEihBB2t5GYmIjExEQAQFxcHLRarc06KpXKrnL0p+uF2VCr1WbzdEY9JEmyWVeCZFZXoVCUacsWjUYDrdbHoTo1Ffdv52OfOxf727nY367hsuTM39/f9DomJgYLFy4EANSqVQs3b940LcvKykJgYKDFNmJjYxEbG2uazszMtLlerVZrVzn6k06nR1FRkdk8IWBXIi0gzOoajcYybdlev47vmZ24fzsf+9y52N/Oxf6uOsHBwVaXuews++zsbNPrw4cPo169egCANm3aYP/+/SgqKkJGRgbS09PRsGFDV4VJRERE5FROGTlbsmQJTp06hdzcXEyYMAGDBg3CyZMnkZqaCkmSEBQUhHHjxgEA6tWrh/bt22PGjBlQKBQYM2YMr9R8gHl7KyHC/jyMmWnUwyvMvsOa7pBwM1VXVaERERHJklOSs2nTppWZ161bN6vl+/fvj/79+1dhROQsdw1GfHbkqmnay1uJO3kGu+q+2Mb6kC8REVF1xSEpIiIiIhlhckZEREQkI0zOiIiIiGSEyRkRERGRjDA5IyIiIpIRJmdEREREMsLkjIiIiEhGmJwRERERyQiTMyIiIiIZYXJGREREJCNMzoiIiIhkhMkZERERkYwwOSMiIiKSEZWrAyDX0xcpoCsUVpcb9BKMBvN5wnpxIiIiug9Mzgi6QoGUpFyry73C1MjLMc/OvLyVVR0WERFRjcTDmkREREQywuSMiIiISEaYnBERERHJCJMzIiIiIhlhckZEREQkI0zOiIiIiGSEyRkRERGRjDA5IyIiIpIRJmdEREREMsLkjIiIiEhGmJwRERERyQiTMyIiIiIZYXJGREREJCNMzoiIiIhkhMkZERERkYwwOSMiIiKSESZnRERERDLC5IyIiIhIRlTOWMny5ctx9OhR+Pn5ISEhAQCwdu1aJCcnQ6VSoU6dOpg4cSK8vLyQkZGB6dOnIzg4GADQqFEjjBs3zhlhEhEREbmcU5Kzrl27olevXli2bJlpXvPmzTF06FAolUqsW7cOmzZtwvDhwwEAdevWRXx8vDNCIyIiIpIVpxzWjIyMhLe3t9m8xx9/HEqlEgDwyCOPICsryxmhEBEREcmaU0bObNm5cyc6dOhgms7IyMCrr74KDw8PDB48GE2aNHFhdERERETO4/LkbOPGjVAqlejUqRMAICAgAMuXL4ePjw8uXryI+Ph4JCQkwNPTs0zdxMREJCYmAgDi4uKg1Wptrk+lUtlVrrq5mp2H7LtFFpcVGPTwDtdYrav2kCBJkvlMCWXnWSChVDk76+F/9dRqNTQaDbRaH7vq1HQ1df92Jfa5c7G/nYv97RouTc5++uknJCcnY968eaY/2Gq1Gmq1GgDQoEED1KlTB+np6YiIiChTPzY2FrGxsabpzMxMm+vUarV2laturufqseLQVYvLjAYgL8dgte74ziEQQpjPFCg7zwKBUuXsrIf/1SsqKoJOp6uR71lF1NT925XY587F/nYu9nfVKb7w0RKX3UojJSUFW7ZswaxZs+Dm5maan5OTA6PRCAC4fv060tPTUadOHVeFSURERORUThk5W7JkCU6dOoXc3FxMmDABgwYNwqZNm6DX67FgwQIAf94y49SpU9iwYQOUSiUUCgXGjh1b5mICIiIiourKKcnZtGnTyszr1q2bxbLt2rVDu3btqjgiIiIiInniEwKIiIiIZITJGREREZGMMDkjIiIikhEmZ0REREQywuSMiIiISEaYnBERERHJCJMzIiIiIhlhckZEREQkI0zOiIiIiGSEyRkRERGRjDA5IyIiIpIRJmdEREREMsLkjIiIiEhGmJwRERERyQiTMyIiIiIZUbk6ACJrfHyUQBiQUaSHMlfYXc/PTQlfjVR1gREREVUhJmckW3cNRnx25Cq8fZVQKO2vN6FtMHw13LWJiOjBxMOaRERERDLC5IyIiIhIRpicEREREckIkzMiIiIiGWFyRkRERCQjTM6IiIiIZITJGREREZGMMDkjIiIikhEmZ0REREQyYndyduDAAYvzDx48WGnBEBEREdV0didnK1assDh/5cqVlRYMERERUU1n8wGE169fBwAYjUZkZGRACGG2TKPRVF10RERERDWMzeRsypQpptcvvfSS2TJ/f38MHDiw8qMiIiIiqqFsJmfr168HALzxxht48803qzwgIiIioprM7nPOmJgRERERVT2bI2fFMjIy8H//939ITU1FQUGB2bKPP/640gMjKslosL+sQS9BX6SASm2suoCIiIiqiN3J2QcffIA6depg5MiRcHNzc2gly5cvx9GjR+Hn54eEhAQAQF5eHhYvXowbN24gKCgI06dPh7e3NwBg06ZN2LlzJxQKBUaPHo0WLVo4tD6qXoQRuJNnf3Z2+5YetdUqqNRVGBQREVEVsTs5u3z5MhYsWACFwvH71nbt2hW9evXCsmXLTPM2b96Mxx57DP369cPmzZuxefNmDB8+HJcvX8b+/fuxaNEiZGdnY8GCBfjggw8qtF4iIiKiB43dGU+TJk2QmppaoZVERkaaRsWKJSUloUuXLgCALl26ICkpyTS/Q4cOUKvVqF27NurWrYvz589XaL1EREREDxq7R86CgoLwzjvv4IknnoC/v7/Zsueee87hFd++fRsBAQEAgICAAOTk5AAAsrKy0KhRI1O5wMBAZGVlOdw+ERER0YPI7uSssLAQrVu3hsFgwM2bN6ssoJI3ubUlMTERiYmJAIC4uDhotVqbdVQqlV3lqpvrhdlQqy2fhKUz6iFJUjm1pbLLJdioYypmXs7OembrdajOvbIajQZarY/ddaqLmrp/uxL73LnY387F/nYNu5OziRMnVuqK/fz8kJ2djYCAAGRnZ8PX1xcAUKtWLbPkLysrC4GBgRbbiI2NRWxs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\n",
      "text/plain": [
       "<Figure size 720x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(10,6))\n",
    "model_plot_df = (model_policy[model_policy[\"prediction\"]>0])\n",
    "sns.histplot(data=model_plot_df, x=\"net_value\", color=\"C2\", label=\"model_policy\")\n",
    "\n",
    "region_plot_df = (model_policy[model_policy[\"region\"].isin(regions_to_invest.keys())])\n",
    "sns.histplot(data=region_plot_df, x=\"net_value\", label=\"region_policy\")\n",
    "\n",
    "plt.title(\"Model Net Income: %.2f;    Region Policy Net Income %.2f.\" % \n",
    "          (model_plot_df[\"net_value\"].sum() / test.shape[0],\n",
    "           region_plot_df[\"net_value\"].sum() / test.shape[0]))\n",
    "plt.legend();"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As we can see, the model generates a better policy than just using the `region` feature, but not by much. While the model policy would have made us about 16.6 reais / customer on the test set, the region policy would have made us only 15.5 / customer. It's just slightly better, but if you have tons and tons of customers, this might already justify using a model instead of a simple one feature policy.\n",
    " \n",
    " \n",
    "## Fine Grain Policy\n",
    " \n",
    "As a recap, so far, we tested the most simple of all policies, which is just engaging with all the customers. This policy can be seen as estimating the marginal net value, $\\hat{E}[NetValue] > 0$. Since that didn't work (the average net income per customer was negative), we developed a single feature policy that was based on regions: we would do business in some regions, but not in others, or $\\hat{E}[NetValue|Region] > 0$. This already gave us very good results. Next, we went full machine learning, with a predictive model that used all the features: $\\hat{E}[NetValue|Region, Income, Age] > 0$. Then, we used that model as an input to a policy and chose to do business with all the customers whose net income predictions were above zero.\n",
    " \n",
    "Here, the decision which the policy handles is very simple: engage with a customer or don't engage. The policies we had so far dealt with the binary case. They were in the form of\n",
    " \n",
    "```\n",
    "if prediction > 0 then do business else don't do business.\n",
    "```\n",
    " \n",
    "This is something we call **thresholding**. If the prediction exceeds a certain threshold (zero in our case, but could be something else), we take one decision, if it doesn't, we take another. One other example of where this could be applied in real life is transactional fraud detection: if the prediction score of a model that detects fraud is above some threshold `X`, we deny the transaction, otherwise we approve it.\n",
    " \n",
    "Thresholding works in lots of real case scenarios and it is particularly useful when the nature of the decision is binary. However, we can think of cases where things tend to be more nuanced. For example, you might be willing to spend more on marketing to get the attention of very profitable customers. Or you might want to add them to some prime customers list, where you give special treatment to them, but it also costs you more to do so. Notice that if we include these possibilities, your decision goes from binary (engage vs don't engage) to continuous: how much should you invest in a customer.\n",
    " \n",
    "Here, for the next example, suppose your decision is not just who to do business with, but how much marketing costs you should invest in each customer. And for the sake of the example, assume that you are competing with other firms and whoever spends more on marketing in a particular customer wins that customer (much like a bidding mechanism). In that case, it makes sense to invest more in highly profitable customers, less in marginally profitable customers and not at all in non profitable customers.\n",
    " \n",
    "One way to do that is to discritize your predictions into bands. We've done this previously for the purpose of model comparison, but here we'll do it for decision making. Let's create 20 bands. We can think of those as quantiles or equal size groups. The first band will contain the 5% less profitable customers *according to our predictions*, the second band will contain from the 5% to the 10% less profitable and so on. The last band, 20, will contain the most profitable customers.\n",
    " \n",
    "Notice that the binning too has to be estimated on the training set and applied on the test set! For this reason, we will compute the bins using `pd.qcut` on the training set. To actually do the binning, we will use `np.digitize`, passing the bins that were precomputed on the training set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>customer_id</th>\n",
       "      <th>region</th>\n",
       "      <th>income</th>\n",
       "      <th>age</th>\n",
       "      <th>net_value</th>\n",
       "      <th>prediction</th>\n",
       "      <th>bands</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>5952</th>\n",
       "      <td>5952</td>\n",
       "      <td>19</td>\n",
       "      <td>1983</td>\n",
       "      <td>23</td>\n",
       "      <td>21</td>\n",
       "      <td>47.734883</td>\n",
       "      <td>18</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1783</th>\n",
       "      <td>1783</td>\n",
       "      <td>31</td>\n",
       "      <td>914</td>\n",
       "      <td>31</td>\n",
       "      <td>-46</td>\n",
       "      <td>-36.026935</td>\n",
       "      <td>7</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4811</th>\n",
       "      <td>4811</td>\n",
       "      <td>33</td>\n",
       "      <td>1349</td>\n",
       "      <td>25</td>\n",
       "      <td>-19</td>\n",
       "      <td>22.553420</td>\n",
       "      <td>15</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>145</th>\n",
       "      <td>145</td>\n",
       "      <td>20</td>\n",
       "      <td>1840</td>\n",
       "      <td>26</td>\n",
       "      <td>55</td>\n",
       "      <td>48.306256</td>\n",
       "      <td>18</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7146</th>\n",
       "      <td>7146</td>\n",
       "      <td>19</td>\n",
       "      <td>3032</td>\n",
       "      <td>34</td>\n",
       "      <td>-17</td>\n",
       "      <td>7.039414</td>\n",
       "      <td>13</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "      customer_id  region  income  age  net_value  prediction  bands\n",
       "5952         5952      19    1983   23         21   47.734883     18\n",
       "1783         1783      31     914   31        -46  -36.026935      7\n",
       "4811         4811      33    1349   25        -19   22.553420     15\n",
       "145           145      20    1840   26         55   48.306256     18\n",
       "7146         7146      19    3032   34        -17    7.039414     13"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def model_binner(prediction_column, bins):\n",
    "    # find the bins according to the training set\n",
    "    bands = pd.qcut(prediction_column, q=bins, retbins=True)[1]\n",
    "    \n",
    "    def binner_function(prediction_column):\n",
    "        return np.digitize(prediction_column, bands)\n",
    "    \n",
    "    return binner_function\n",
    "    \n",
    "\n",
    "# train the binning function\n",
    "binner_fn = model_binner(train_pred[\"predictions\"], 20)\n",
    "\n",
    "# apply the binning\n",
    "model_band = model_policy.assign(bands = binner_fn(model_policy[\"prediction\"]))\n",
    "model_band.head()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [
    {
     "data": {
      "image/png": "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8MMPNWjQIPn6+kqSgoKCTK13hmEY+vzzz3XVVVeZWs9ms6m0tFTS6fdTd77H1FYvMzNTXbp0kSRdfvnl+s9//uOWWmf7LHf3+wvTpg1QTk6OfvjhB7cdMj4bh8OhqVOnKjs7WzfccIMiIyNNrffqq6/qrrvucv6C1ofnnntOktS/f39Try7KyclRq1attHTpUh0+fFidOnXSPffc4wzIZvrss8/c+sb6v0JCQnTTTTdp/Pjx8vPzU7du3dStWzfT6kVEROiNN95QcXGx/Pz89OWXX7p1SvFsCgsLnR8YwcHBKioqMr2mp2zevFmxsbGm13n99de1bds2BQQEaObMmabW2rFjh0JCQnTxxRebWufnNm3apG3btqlTp066++67TQ14WVlZ2rdvn9544w35+vpqxIgRpn9GSNI333yjoKAgtWvXztQ6I0eO1HPPPac1a9bI4XDo2WefNbVeRESEduzYoZiYGH3xxRfKy8tze42ff5a7+/2FI28NTFlZmebNm6d77rnHLfPvv8TLy0tz587VsmXLdPDgQR05csS0WmlpaQoKCnL+RVIfZs2apTlz5mjatGnatGmT9u7da1qtqqoq/fDDD7r++uv117/+Vc2aNdO6detMq3dGZWWl0tLS1Lt3b9NqlJSUKDU1VYmJiXr55ZdVVlambdu2mVavY8eOGjRokJ599lk9//zz+tWvfiUvL96q3GXt2rXy9vbW1VdfbXqt22+/XS+99JLi4uK0ceNG0+qUl5dr7dq1GjZsmGk1/tf111+vxYsX669//auCg4P12muvmVrP4XCopKREzz33nEaMGKEFCxbIqIebRZj9x+EZH374oUaOHKmXXnpJI0eO1LJly0ytN378eG3atElTp05VaWmpfHzceyzL7M9y3hEbkMrKSs2bN09XX321rrzyynqr26JFC3Xt2lXp6emm1fj222+1Y8cOPfDAA1q4cKF2796tRYsWmVZPkvPk6KCgIMXExOjAgQOm1QoNDVVoaKjz6GXv3r31ww8/mFbvjC+//FK//vWv1bp1a9Nq7Nq1S2FhYWrVqpV8fHx05ZVX6rvvvjOtniRdd911mjNnjp5++mkFBgaa/le/dPr/k4KCAklSQUGB2052b0i2bNmitLQ0TZw40fTTJH4uLi7ObdNStfnpp5+Uk5OjKVOm6IEHHlBeXp6mTp2q48ePm1azdevW8vLykpeXl/r166eDBw+aVks6/X525ZVXymazqXPnzvLy8lJxcbGpNauqqrR9+/Z6OUq7detW5+denz59TH2/lqQOHTroiSee0Jw5c3TVVVepbdu2btt2bZ/l7n5/Ibw1EIZhaNmyZerQoYNuvPFG0+sVFRXpxIkTkk5febpr1y516NDBtHp33HGHli1bpsTERP3pT3/SpZdeqokTJ5pWr6yszDk9W1ZWpq+//loXXXSRafVat26t0NBQ59VZu3btUseOHU2rd0Z9/FVst9u1f/9+lZeXyzAM0/9fkU5PYUqnr9zavn17vfzlHx0dra1bt0o6/UESExNjes36lJ6ervXr12vq1Klq1qyZ6fWysrKcP+/YscO08/sk6aKLLtKKFSuUmJioxMREhYaGas6cOab+UXPmg1iStm/froiICNNqSVJMTIx2794t6fT5WpWVlWrZsqWpNXft2qX27dsrNDTU1DrS6XB6ZnZk9+7dCg8PN7XemfcYh8OhtWvXqn///m7Z7tk+y939/sJNen/BwoULtXfvXhUXFysoKEhDhw51npDubvv27dOMGTN00UUXOf8iduel5//r8OHDSkxMlMPhkGEY6tOnj2677TZTav2vPXv2aMOGDabeKuSnn37SCy+8IOn0X49xcXEaMmSIafWk05eeL1u2TJWVlQoLC9OECRNMPQemvLxc48eP15IlS0yfYn/rrbeUkpIib29vXXzxxRo3bpzzxGkzzJgxQ8XFxfLx8dHdd9+tyy67zK3br+13OyYmRgsWLFBubq7sdrsmT57stv9+tdULDAzUK6+8oqKiIrVo0UIXX3yxpk+fblq9pKQkVVZWOvcpMjJSY8eONa3ezp07lZWVJZvNJrvdrrFjx7rtViHnem9+4IEH9Je//MVtR09rq7dnzx4dOnRINptNbdq00dixY912kn1t9eLj453n1Pr4+GjEiBG69NJLTat33XXXKTExUZGRkbr++uvdUueX6rVv316rVq2Sw+GQr6+vxowZ47bTbGqrV1ZWpk2bNkmSrrjiCt1xxx1uORp9ts/yyMhIt76/EN4AAAAshGlTAAAACyG8AQAAWAjhDQAAwEIIbwAAABZCeAMAALAQwhuAJuuBBx7Q119/3WjqAGgaCG8AAAAWQngDAACwEPd+EysAWMzBgwe1atUqHT9+XDExMRozZowqKiq0ZMkS7d+/Xw6HQ7/5zW903333Ob8m6KmnntJvf/tb7dmzR4cPH1ZUVJQmTpzovKP/tm3b9MYbb6isrKzG190dOHBAK1asUFZWlvz8/BQXF6eRI0fW+34DsC6OvAFo0j799FNNnz5dixcvVlZWltauXSvDMHTNNddo6dKlWrp0qfz8/LRy5cpq63322WcaP368VqxYocrKSm3YsEGSlJGRoeXLl+vBBx/Uyy+/rOLiYuXl5TnXW7VqlQYMGKDVq1dr8eLF6tOnT73uLwDrI7wBaNJuuOEG2e12BQYGavDgwfrss8/UsmVL9e7dW82aNZO/v7+GDBmib775ptp611xzjdq3by8/Pz/16dNHhw4dkiR98cUX6tWrl7p27SpfX18NGzas2ncm+vj4KDs7W0VFRWrevLmioqLqc3cBNAJMmwJo0ux2u/PnNm3aKD8/X+Xl5Vq9erXS09N14sQJSVJpaakcDoe8vE7/zdu6dWvnes2aNVNZWZkkKT8/3zm9KknNmzdXy5Ytnc/HjRunN998U5MmTVJYWJhuu+029erVy8xdBNDIEN4ANGm5ubnVfg4JCdGGDRuUmZmp559/Xq1bt9ahQ4f06KOPyjCMc24vODhYR48edT4vLy9XcXGx83m7du30pz/9SQ6HQ9u3b9f8+fO1cuVKNW/e3L07BqDRYtoUQJO2adMm5eXlqaSkRElJSerTp4/Kysrk5+engIAAlZSU6O23367z9nr37q20tDTt27dPlZWVevPNN6uFvm3btqmoqEheXl4KCAiQJOfRPACoC468AWjS4uLi9Oyzz6qgoEDR0dG69dZbdeLECS1atEijR49WSEiIbrzxRqWmptZpexERERo9erRefPFFlZeX68Ybb6w2jZqenq7XXntN5eXlatOmjR5++GH5+fmZtXsAGiGbUZd5AAAAADQIHKsHAACwEMIbAACAhRDeAAAALITwBgAAYCGENwAAAAshvAEAAFgI4Q0AAMBCCG8AAAAWQngDAACwkP8P876ajqwkhMkAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 720x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.figure(figsize=(10,6))\n",
    "sns.barplot(data=model_band, x=\"bands\", y=\"net_value\")\n",
    "plt.title(\"Model Bands\");"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With these bands, we can allocate the bulk of our marketing investments to band 20 and 19. Notice how we went from a binary decision (engage vs not engage), to a continuous one: how much to invest on marketing for each customer. Of course you can fine tune this even more, adding more bands. In the limit, you are not binning at all. Instead, you are using the raw prediction of the model and you can create decision rules like\n",
    " \n",
    "```\n",
    "mkt_investments_i = model_prediction_i * 0.3\n",
    "```\n",
    " \n",
    "where for each customer $i$, you invest 30% of the net_value predicted by the model (30% was an arbitrary number, but you get the point).\n",
    " \n",
    "## Key Ideas\n",
    " \n",
    "We've covered A LOT of ground here in a very short time, so I think this recap is extremely relevant for us to see what we accomplished here. First, we learned how the majority of machine learning applications involve nothing more than making good predictions, where prediction is understood as mapping from a known input to an initially unknown, but well defined output. We can also understand prediction as estimating an expectation function $E[Y|X]$. But when I say \"nothing more\", I'm not being entirely fair. We also saw how good predictions can solve more problems than we might realize at first sight, like language translation and self-driving cars. \n",
    " \n",
    "Then, we got back down to earth and looked at how good predictions can help us with more common tasks, like figuring out which customer we should bring in and which to avoid. Specifically, we looked at how we could predict customer profit. With that prediction, we built a policy that decides who we should do business with. Notice that this is just an example of where prediction models can be applied. There are sure to be tonnes of other applications, like credit card underwriting, fraud detection, cancer diagnostics and anything else where good predictions might be useful.\n",
    " \n",
    "The key takeaway here is that **if you can frame your business problem as a prediction problem, then machine learning is probably the right tool for the job**. I really can't emphasize this enough. With all the hype around machine learning, I feel that people forget about this very important point and often end up making models that are very good at predicting something totally useless. Instead of thinking about how to frame a business problem as a prediction problem and *then* solving it with machine learning, they often build a prediction model and try to see what business problem could benefit from that prediction. This might work, but, more often than not, is a shot in the dark that only generates solutions in search of a problem.\n",
    " \n",
    "## References \n",
    " \n",
    "The things I've written here are mostly stuff from my head. I've learned them through experience. This means there isn't a direct reference I can point you to. It also means that the things I wrote here have **not** passed the academic scrutiny that good science often goes through. Instead, notice how I'm talking about things that work in practice, but I don't spend too much time explaining why that is the case. It's a sort of science from the streets, if you will. However, I am putting this up for public scrutiny, so, by all means, if you find something preposterous, open an issue and I'll address it to the best of my efforts. \n",
    " \n",
    "Finally, I believe I might have been too quick for those who were hoping for a comprehensive and detailed introduction of machine learning. To be honest, I believe that where I can truly generate value is teaching about causal inference, not machine learning. For the latter, there are tons of amazing online resources, much better than I could ever dream of creating. The classical one is [Andrew Ng's course on Machine Learning](https://www.coursera.org/learn/machine-learning) and I definitely recommend you take a look into it if you are new to machine learning.\n",
    " \n",
    "## Contribute\n",
    " \n",
    "Causal Inference for the Brave and True is an open-source material on causal inference, the statistics of science. It uses only free software, based in Python. Its goal is to be accessible monetarily and intellectually.\n",
    "If you found this book valuable and you want to support it, please go to [Patreon](https://www.patreon.com/causal_inference_for_the_brave_and_true). If you are not ready to contribute financially, you can also help by fixing typos, suggesting edits or giving feedback on passages you didn't understand. Just go to the book's repository and [open an issue](https://github.com/matheusfacure/python-causality-handbook/issues). Finally, if you liked this content, please share it with others who might find it useful and give it a [star on GitHub](https://github.com/matheusfacure/python-causality-handbook/stargazers)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "celltoolbar": "Tags",
  "kernelspec": {
   "display_name": "causal-glory",
   "language": "python",
   "name": "causal-glory"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.9.7"
  },
  "toc": {
   "base_numbering": 1,
   "nav_menu": {},
   "number_sections": true,
   "sideBar": true,
   "skip_h1_title": false,
   "title_cell": "Table of Contents",
   "title_sidebar": "Contents",
   "toc_cell": false,
   "toc_position": {},
   "toc_section_display": true,
   "toc_window_display": false
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}
